home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / misc / moonpo22.zip / MOONPO.DOC < prev    next >
Text File  |  1994-05-16  |  28KB  |  563 lines

  1.  
  2.  
  3.  
  4.  
  5.         ******* WARNING ***** WARNING ***** WARNING ***** WARNING *********
  6.         *                                                                 *
  7.         * THE AUTHOR OF THIS SOFTWARE DOES NOT PROVIDE ANY WARRANTY WHAT- *
  8.         * SOEVER! YOU USE IT OR TRY IT ENTIRELY AND STRICTLY AT YOUR OWN  *
  9.         * RISK. THE AUTHOR EXPRESSLY DISCLAIMS ANY LIABILITY FOR DAMAGE   *
  10.         * TO YOUR COMPUTER, FILES OR ASSOCIATED ELECTRO-MECHANICAL        *
  11.         * DEVICES. NOR IS THERE ANY GUARANTEE AS TO THE ACCURACY OF THE   *
  12.         * RESULTS OR AS TO THE FITNESS OF THE MOONPO PROGRAM FOR ANY      *
  13.         * PARTICULAR PURPOSE.                                             *
  14.         *                                                                 *
  15.         *    REMEMBER, YOU USE IT OR TRY IT SOLELY AT YOUR OWN RISK!      *
  16.         *                                                                 *
  17.         ******* WARNING ***** WARNING ***** WARNING ***** WARNING *********
  18.  
  19.         1.0 GENERAL INFORMATION
  20.         
  21.         MOONPO is a Windows 3.x application which can calculate the azimuth
  22.         and elevation of the moon and the sun (and the phase of the moon)
  23.         as a function of the date and time of day at any place on the earth
  24.         (with the possible exception of the poles and precisely where the
  25.         0 or 180 degree meridians cross the equator). It will also compute
  26.         the approximate rising and setting times and the azimuth of the moon
  27.         and sun at those times.
  28.  
  29.         MOONPO's results are displayed as a table showing the local and GMT
  30.         time in a 24 hour "military" format (for example, 6:34 PM would
  31.         appear as 1834). Azimuth angles are measured clockwise from north
  32.         (so, due south corresponds to an azimuth angle of 180 degrees).
  33.         Elevations are measured from a level horizon (straight up is a 90
  34.         degree elevation angle). Results may be printed on the default
  35.         Window printer and may be saved in an ascii formatted file for
  36.         later printing or other use. Moonpo can also display and print
  37.         simple graphs showing the azimuth and elevation of the sun as a
  38.         function of the time of day. The azimuth and elevation values
  39.         are usually accurate to within about 2 degrees.
  40.  
  41.         In order to actually run MOONPO you need to know your geographical
  42.         longitude and latitude in at least degrees and minutes. You also
  43.         need to know or figure out a "time zone" value for your location.
  44.         Data for a few cities may be found below.
  45.  
  46.         Execution of MOONPO requires a computer with at least an 80286
  47.         cpu and an 80x87 math coprocessor or its  equivalent (80486,
  48.         for example).
  49.  
  50.  
  51.         MOONPO is distributed as Shareware. That means you may try it for a
  52.         reasonable period (say three weeks) at no cost, but that you should
  53.         register it and pay the registration fee if you use it after the
  54.         trial period.
  55.  
  56.  
  57.  
  58.         2.0 INSTALLATION INFORMATION
  59.  
  60.         2.1 STANDARD FILES
  61.         
  62.         The MOONPO files included in the authorized archive are:
  63.  
  64.              MOONPO.EXE   - Windows 3.x executable application file.
  65.              MOONPO.BMP   - Logo bitmap file.
  66.              MOONPO.DOC   - This file.
  67.              MOONPO.HLP   - MoonPo help file.
  68.              MYLOCALE.INI - User location customization file for MOONPO.
  69.              GSW.EXE      - Graphics server executable file.
  70.              GSWDLL.DLL   - Dynamic link library for graphics server.
  71.              READTHIS.NOW - Minimal installation information.
  72.              ILUM93.DTA   - Some high precision results for MOONPO
  73.                             validation.
  74.              WHATSNEW.220 - Changes from version 1.0.
  75.              VALIDATE.DAT - Antivirus data for McAfee Associates
  76.                             VALIDATE.COM (Version 0.4)
  77.  
  78.  
  79.         2.1 RECOMMENDED INSTALLATION INFORMATION
  80.         
  81.         MOONPO must be installed using DOS commands or the Windows
  82.         File Manager. A few essential instructions follow.
  83.  
  84.         While some components of MOONPO can be placed in different directories,
  85.         the simplest thing to do is to put all of the files in a single MOONPO
  86.         directory. That makes removal simple.
  87.  
  88.         Sample MOONPO Installation Procedure:
  89.  
  90.         This example assumes the following:
  91.  
  92.         A) Your base Windows directory is C:\WINDOWS.
  93.         B) You will place all MOONPO files (EXCEPT MYLOCALE.INI, which MUST
  94.             be in your base Windows directory) in a NEW directory on fixed
  95.             drive D:
  96.         C) The (de-archived) MOONPO files are on a diskette in diskette
  97.            drive B:, and there are no other files on that diskette.
  98.         D) The installation will be done from DOS or a DOS Window, and that
  99.            your DOS "prompt" appears as C:\>
  100.  
  101.         Note: in the following example the term <CR> means that you press the
  102.               "RETURN" or "ENTER" key.
  103.  
  104.         1) Create the MOONPO directory:
  105.  
  106.            C:\> MKDIR D:\MOONPO <CR>
  107.  
  108.         2) Copy files:
  109.  
  110.            C:\> Copy B:\MYLOCALE.INI C:\WINDOWS
  111.            C:\> Copy B:\*.* D:\MOONPO
  112.  
  113.         NOTE: If you are using OS/2 Version 2.0 or later, you should puy
  114.         MYLOCALE.INI in your \OS2\MDOS\WINOS2 directory.
  115.  
  116.  
  117.  
  118.         3) Running or Preparing to Run MOONPO:
  119.  
  120.         METHOD 1: a) Click on the Program Manager's "File" option and
  121.                      select "Run".
  122.                   b) Enter D:\MOONPO\MOONPO.EXE and <CR>.
  123.  
  124.         METHOD 2: (add MOONPO to an existing group of applications)
  125.                   a) Click on (or TAB to) the title bar of the desired
  126.                      group.
  127.                   b) Select the Program Manager's "File" option, and then
  128.                      "New".
  129.                   c) Select "Program Item".
  130.                   d)   i) For the "Description" enter: MOONPO
  131.                       ii) For the "Command Line" enter:
  132.                           D:\MOONPO\MOONPO.EXE
  133.                      iii) For "Working directory" enter: D:\MOONPO
  134.                       iv) Select "OK".
  135.  
  136.         If all is well, then the MOONPO icon will appear in the program
  137.         group box and you can start MOONPO by clicking on that icon.
  138.  
  139.         Before running MOONPO, you will probably want to customize it for
  140.         your geographical location. There are two ways to do that:
  141.  
  142.         1) Edit the MYLOCALE.INI file to reflect your longitude, latitude and
  143.            time zone before starting the MOONPO application. You may use
  144.            any convenient ASCII editor and edit it to replace the sample
  145.            data with that appropriate to your geographical location (also
  146.            see discussion below). Doing that will make it unnecessary for
  147.            you to re-enter your location data each time you want to run
  148.            MOONPO.
  149.  
  150.            If you use MYLOCALE.INI, be sure to set the "TIMZON" parameter.
  151.            Your time zone is the number of hours you need to add to
  152.            Greenwich Mean Time (or more properly UTC) to get your local
  153.            24-hour time. West longitudes have negative (or zero) TIMZON
  154.            values (they are "earlier"), while East longitudes have
  155.            positive values. If you do not enter a value, one will be
  156.            calculated from your longitude, but it may not be correct
  157.            since local time zones don't adhere very closely to the way
  158.            the earth rotates.
  159.  
  160.            DO NOT EDIT MYLOCALE.INI USING A WORD PROCESSING PROGRAM (SUCH
  161.            AS WORDPERFECT, WORD FOR WINDOWS OR DOS, ETC) UNLESS YOU ARE
  162.            SURE YOU KNOW HOW TO WRITE THE EDITED FILE IN PLAIN OLD ASCII
  163.            FORM CONTAINING NO EXTRANEOUS INFORMATION INSERTED BY THE
  164.            WORDPROCESSING PROGRAM. MS-DOS'S EDITOR OR THE WINDOWS
  165.            NOTEPAD EDITOR ARE SUGGESTED.
  166.  
  167.  
  168.         2) Simply start MOONPO and then enter your location and time
  169.            zone via the "Observer Position" option under the "Control data"
  170.            menu item found on the main MOONPO menu bar. Once you select
  171.            "OK" you will be asked if you wish to save the new data in the
  172.            MYLOCALE.INI file. Choosing "Yes" will save the customized
  173.            MYLOCALE.INI file.
  174.  
  175.  
  176.  
  177.         If you will NEVER want to examine MOONPO's graphs, you can omit
  178.         copying of the "GSW..." files (or delete them later).
  179.  
  180.         If you already have a copy of GSW.EXE and GSWDLL.DLL in a directory
  181.         named in  your AUTOEXEC.BAT's PATH= statement, then you can probably
  182.         save some diskspace by deleting GSW.EXE and GSWDLL.DLL from the
  183.         MOONPO directory. The GSW.. files probably must belong to at least
  184.         version 2.1, however.
  185.  
  186.  
  187.         3.0 RUNNING MOONPO
  188.  
  189.         When you run MOONPO you will normally want to override the default
  190.         information such as your geographical location, the year and the
  191.         date for which you want to learn something about the positions of
  192.         the sun and moon. So, if you do not know them, you need to learn
  193.         your geographical longitude and latitude. Most road maps show such
  194.         data along the margins and you can probably interpolate to find
  195.         the data for your own town will sufficient accuracy. You will also
  196.         need to enter your time zone, as discussed above. The data just
  197.         mentioned are entered by running the "Control Data" dialog to be
  198.         discussed in Section 3.2.
  199.  
  200.         You can begin execution of MOONPO.EXE by clicking the Windows
  201.         Program Manager's "File" menu item and then the "Run" item from
  202.         the popup menu. Then you simply enter the complete path name needed
  203.         to locate MOONPO.EXE. If you placed MOONPO.EXE in your base
  204.         Windows directory you can omit the directory portion of the file
  205.         name. MOONPO has no command line parameters.
  206.  
  207.         If you added MOONPO to a program group, then just start it in the
  208.         usual fashion.
  209.  
  210.         When you start MOONPO you will be greeted by a more or less blank
  211.         screen. There is no "cursor". There is a standard menu bar at the
  212.         top of the screen. Choices are accessed in the usual Windows manner.
  213.  
  214.         The menu choices are as follows:
  215.         
  216.         File  Control Data  Run  Moonrise  Reset Graph  Help
  217.  
  218.  
  219.         3.1 The "File" Menu Item
  220.         
  221.         Clicking on the "File" option brings up a popup menu composed of
  222.         four items: "New", "SaveAs", "Print" and "Exit".
  223.  
  224.         Selecting "New" simply clears any previous results from the screen
  225.         and memory and resets some internal flags.
  226.  
  227.         The File "SaveAs" option is chosen to initiate saving of the
  228.         current results into an ascii file. It works pretty much as you
  229.         might expect.
  230.  
  231.         The "Print" option will dump the currently displayed numerical
  232.         results to the DEFAULT Windows printer. You must handle all
  233.         default printer setup operations via the Windows Print Manager.
  234.  
  235.         The "Exit" option terminates MOONPO.
  236.  
  237.  
  238.  
  239.         3.2 The "Control Data" Menu Item
  240.         
  241.         This item also brings up a popup menu with two sub-choices:
  242.         "Observer Position" and "Time of Day".
  243.  
  244.         If you have not copied the MYLOCALE.INI file to your Windows directory
  245.         you should click on the "Observer Position" choice and enter your
  246.         geographical data, and a time zone value in the spots provided.
  247.         (See section 2.1 (above) for a few comments on time zones, and
  248.         Section 5.0 (below) for sample data.
  249.  
  250.         If you have made a change in the observer position or time zone
  251.         data, then when you exit from  the dialog via the "Ok" button you
  252.         will be asked if you wish to save the changes in the MYLOCALE.INI
  253.         file. If you answer "yes" then all the file data will be replaced.
  254.         
  255.         You will need to execute the "Time of Day" dialog to set the month
  256.         and day of the month for which you want  position data. Within
  257.         that dialog you also set the hours for the first and last times of
  258.         day and the increment in minutes for the calculations. All the
  259.         input numbers are expected to be integers with no  decimals, etc.
  260.         Some, but not all, parameters are checked before a run, so if you
  261.         enter any oddball values (like ~23, for example), all bets are off.
  262.  
  263.  
  264.         3.3 The "Run" Menu Item
  265.         
  266.         Choosing the "Run" menu item is the action which actually causes
  267.         something to happen to produce data to be displayed in the blank
  268.         window. There will probably be something of a delay before you
  269.         see any results because MOONPO does all calculations before it
  270.         displays any results.
  271.  
  272.  
  273.         3.4 The "Moonrise" Menu Item
  274.         
  275.         This item initiates iterative calculations which attempt to find
  276.         the APPROXIMATE times at which the moon crosses the horizon (or
  277.         for which the elevation angle is zero). These calculations may
  278.         also take a while if you do not have a fast computer. Those times
  279.         and the approximate azimuth  angles at those times are then shown in
  280.         a popup window. The results are nominal "astronomical" values and
  281.         are not corrected for refractive atmospheric effects or topography.
  282.         Refractive effects advance moon(sun)rise and delay moon(sun)set by
  283.         about half a degree.
  284.  
  285.         3.5 The "Reset" Menu Item
  286.         
  287.         Choosing the "Reset" menu item erases the "worksheet" and prepares
  288.         some internal flags for "new" calculations. "Reset" does not, 
  289.         however, alter the observer or time of day data. "Reset" performs
  290.         the same actions as the "File New" choice (see above).
  291.  
  292.  
  293.  
  294.         3.6 The "Graph" Menu Item
  295.  
  296.         Select this item by mouse click or Alt+G to get simple graphs of
  297.         elevation and azimuth angles (in degrees) vs local time (hours).
  298.         They are displayed in an independent window. Negative elevation
  299.         angles will not appear on the graph. The horizontal (abscissa)
  300.         axis is your local time in hours, and the vertical (ordinate)
  301.         axes will be the elevation (above the theoretical horizon) and
  302.         azimuth angles in degrees.
  303.  
  304.         A displayed graph may be printed using the auxillary menu bar
  305.         options seen at the top of each graph. However, YOUR PRINTER
  306.         MUST HAVE GRAPHICS CAPABILITIES! If it doesn't, you may get a
  307.         lot of blank sheets of paper!. Other options found on the graph
  308.         windows' menu allow you to adjust the size and placement of the
  309.         graph on the page. Use the graph window's Help option to assist
  310.         you if desired. Normally, the graphs are scaled to fill about a
  311.         complete printer page (X and Y scale factors = 1.0). Only scale
  312.         factors smaller than 1.0 are suggested. You can also change the
  313.         placement of a graph on paper by setting the Position offsets
  314.         (entry unit is millimeters). Registered users can save their own
  315.         values for those items.
  316.  
  317.         Use the Alt + Spacebar keys and then select the CLOSE popup menu
  318.         item to close the graph window if you don't havσ a mouse.
  319.  
  320.  
  321.         3.7 The "View" Menu Item
  322.  
  323.         This command may be used to draw rough sketches of the appearance
  324.         of the moon at three-hour intervals. The views illustrate the
  325.         expected light and dark portions as seen by an observer looking
  326.         directly at the moon at the various times. Sketches are drawn
  327.         clockwise, with the top most sketch being for local midnight
  328.         (0000 hrs), and the lowest one for local noon (1200 hrs). Times
  329.         are shown in a four digit HHMM format, with the date and the
  330.         observer's location shown at the center of the window. Sketches
  331.         may not be properly shaded in cases in which the bright or dark
  332.         portion of a sketch should be a very narrow cresent. Either the
  333.         desired bright crescent may be incorrectly blackened, or a
  334.         crescent which should be blackened may not turn out that way.
  335.         That behavior is a result of the finite size of the pixels used
  336.         in the Windows environment (or perhaps the GSW graphics server ?).
  337.         The background color of the individual sketches is light blue or
  338.         cyan if the sun is above the local horizon at a given time and
  339.         black otherwise.
  340.  
  341.         Please note that the sketches DO NOT appear on the screen in
  342.         a position that somehow relates to its position in the sky.
  343.  
  344.         The entire sketch may also be saved in a file with any one of the
  345.         following file types: 1) ".BMP", 2) ".WMF" or 3) ."WFM" by using
  346.         the FileSaveAs command of the File popup menu. Simply specify one
  347.         of the three preceding file "extensions" when you enter the name
  348.         to be used for the file to be created.
  349.  
  350.  
  351.         3.8 The "Help" Menu Item
  352.         
  353.         This one brings up another popup menu from which you can select
  354.         the Index for the MoonPo help file, the Windows Help on Help file
  355.         or maybe the About Moonpo dialog
  356.  
  357.  
  358.  
  359.         4.0 OTHER IMPORTANT INFORMATION
  360.  
  361.         MOONPO is distributed as Shareware. If you use it after some
  362.         reasonable trial period, please send the author $ 12.50 (US) for
  363.         his trouble. Its the right thing to do! It will also make you feel
  364.         better and will get you on a mailing list for information about
  365.         any fixup versions or future enhanced versions. (Please send
  366.         $ 15 (US) if you want to receive a pristine diskette copy of the
  367.         latest version-in which case also tell me the disk size needed.
  368.  
  369.         You may not incorporate MOONPO into any commercial package without
  370.         express written approval of the author, but you may feel free to
  371.         give away unmodified copies of the demonstration archive (but not
  372.         individual files) or post copies of it on any BBS which will accept
  373.         it AND which makes no charges other than those made on the basis of
  374.         connect time. The MOONPO version in the demonstration archive will
  375.         function only for years 1991-1994. You can obtain a version usable
  376.         later years by registering your copy.
  377.  
  378.         If you are using an unregistered copy of MOONPO version 2.1 or later
  379.         which functions outside the years 1991-1994, then is is an ILLEGAL
  380.         copy (and may also give incorrect results!). If you obtained such a
  381.         copy from a BBS, please inform the SYSOP that said copy is NOT
  382.         authorized for public release.
  383.  
  384.  
  385.         Send your registration fee as well as any constructive comments or
  386.         suggestions to:
  387.  
  388.         August Miller
  389.         P.O Box 3512
  390.         Las Cruces, NM 88003-3512 (U.S.A.)
  391.  
  392.         Internet: amiller@nmsu.edu
  393.  
  394.         Note: Please remit registration fees by check or money order. Cash
  395.               never seems to arrive. ALL registrants will receive written
  396.               acknowledgements upon receipt of the registration fee.
  397.  
  398.         IF YOU ENCOUNTER ANY "ABNORMAL" BEHAVIOR, PLEASE SEND AS MUCH
  399.         INFORMATION ABOUT ITS NATURE AND CIRCUMSTANCES UNDER WHICH IT
  400.         WAS OBSERVED TO AUTHOR.
  401.  
  402.                                 * ADVERTISEMENT *
  403.  
  404.         There is also a SUNPO which provides low resolution angular position
  405.         data for the sun PLUS general estimates of the intensity of solar
  406.         visible, UV-A and UV-B radiation with any one of four user selectable
  407.         models for the atmosphere. Look for SUNPO131.ZIP. The registration fee
  408.         for SUNPO is $ 5.00 (U.S.), or $ 7.50 if you want a directly shipped
  409.         diskette. $ 20.00 will get you a diskette containing both the latest
  410.         SUNPO and MOONPO files.
  411.  
  412.                                 * ADVERTISEMENT *
  413.  
  414.  
  415.  
  416.         5.0 MISCELLANEOUS INFORMATION 
  417.  
  418.         5.1 Geographical Coordinates for some cities:
  419.  
  420.         In case you don't know where you are, here are a few clues:
  421.  
  422.                             Latitude       Longitude      TimeZone
  423.                             -------------  ------------   --------
  424.         Atlanta, GA         33D 21M North   84D 22M West     - 5
  425.         Boston, MA          41D 21M North   71D  3M West     - 5
  426.         Chicago, IL         41D 52M North   87D 37M West     - 6
  427.         Dallas, TX          32D 47M North   96D 47M West     - 6
  428.         Denver, CO          39D 44M North  104D 59M West     - 7
  429.         El Paso, TX         31D 45M North  106D 29M West     - 7
  430.         Fairbanks, AK       64D 48M North  147D 51M West     - 9
  431.         Las Cruces, NM      32D 19M North  106D 47M West     - 7
  432.         Los Angeles,CA      34D  3M North  118D 14M West     - 8
  433.         New Orleans, LA     29D 56M North   90D  3M West     - 6
  434.         Phoenix, AZ         33D 26M North  112D  3M West     - 7
  435.         San Francisco, CA   37D 47M North  122D 25M West     - 8
  436.         Seattle, WA         47D 37M North  122D 19M West     - 8
  437.  
  438.         London              51D 32M North    0D  4M West       0
  439.         Hamburg             53D 33m North   10D  2M East     + 1
  440.         Capetown            33D 55M South   18D 22M East     + 2
  441.         Guayaquil            2D 10M South   79D 56M West     - 5
  442.         Irkutsk             52D 30M North  104D 19M East     + 7
  443.         Bangkok             13D 45M North  100D 30M East     + 7
  444.         Manila              14D 34M North  120D 56M East     + 9 (I think)
  445.         Mexico City         19D 26M North   99D  7M West     - 6
  446.         Rio de Janeiro      22D 56M South   43D 11M West     - 3
  447.         Tokyo               35D 45M North  139D 45M East    + 10
  448.  
  449.         wherein, "D" means degrees and "M" means minutes. Some of time zone
  450.         values are based on longitude alone. They may be off by an hour or
  451.         so either way in a few cases due to the author's ignorance of local
  452.         customs.
  453.  
  454.         5.2 Eclipse Warnings
  455.  
  456.         MOONPO will occasionally issue "Eclipse Warnings". These warnings
  457.         are issued if  the angular positions of the sun and the moon are
  458.         approximately those for which a solar or lunar eclipse might occur.
  459.         Since the precision of MOONPO's calculations is rather low, such
  460.         warnings may well be "false alarms". If you see such a warning and
  461.         are really interested in the possibility of an eclipse, you may
  462.         wish to consult a more precise source of astromomical data for the
  463.         date in question. The magazine "Sky and Telescope" is a good place
  464.         to look and is probably available in your local public library.
  465.  
  466.  
  467.  
  468.  
  469.         6.0 DISPLAY INFORMATION
  470.  
  471.         For an observer located as in the sample MYLOCALE.INI file, the screen
  472.         display and the ascii output files look something like:
  473.  
  474.            Local Global  Lunar  Lunar    Lunar   Solar   Solar Observ.
  475.             time   time  Azim.  Elev.    Phase   Azim.   Elev. Params.
  476.                                                                       
  477.              600   1300     62     -7     -161      69      11    1993
  478.              700   1400     70      4     -160      76      23  21 Jun
  479.              800   1500     77     16     -160      83      35  32.3 N
  480.              900   1600     84     28     -159      90      48 106.8 W
  481.             1000   1700     92     40     -159      99      60        
  482.             1100   1800    102     52     -158     116      73        
  483.             1200   1900    116     63     -158     168      81        
  484.             1300   2000    143     73     -157     235      76        
  485.             1400   2100    194     75     -157     257      64        
  486.             1500   2200    233     68     -156     268      51        
  487.             1600   2300    252     57     -156     275      39        
  488.             1700   2400    262     46     -154     282      26        
  489.             1800    100    271     33     -154     289      14        
  490.             1900    200    278     21     -154     297       2        
  491.             2000    300    285      9     -153     305      -9        
  492.  
  493.  
  494.  
  495.  
  496.        7.0 PROGRAMMING INFORMATION
  497.  
  498.        The numerical algorithms utilized in MOONPO are loosely based on
  499.        information from several sources but primarily use the "low
  500.        precision" equations found in the 1993 edition of the Astronomical
  501.        Almanac for describing the positions of the moon and sun as seen
  502.        from the earth. A recommended reference book for anyone who wishes
  503.        to learn more about doing astronomical calculations on personal
  504.        computer is "Astronomy on a Personal Computer" by O. Montenbruck
  505.        and T. Pfleger, (translated by S. Dunlop) and  published by Springer
  506.        Verlag, 1991. A good source of high precision tables is the
  507.        Astronomical Almanac (published yearly). The developer of MOONPO
  508.        is also indebted to high precision FORTRAN program ILLUM by Ir.
  509.        A. Van Bochove and M. Erlich which has been used for testing the
  510.        validity of the low precison (but faster!) routines.
  511.  
  512.        All programming and compiling of MOONPO was done using
  513.        Version 1.5 of Borland International's Turbo Pascal for Windows.
  514.        Note however, that the drawing and printing of graphs is
  515.        handled by the GSW.EXE and GSWDLL.DLL routines. The latter
  516.        "runtime routines" are products of Bits Per Second, Ltd. and
  517.        Pinnacle Publishing, Inc. and are included under the licensing
  518.        provisions of their Graphics Server SDK Version 2.2.
  519.  
  520.        Low precision formulas for the positions of the moon and sun
  521.        have been used to accelerate the calculations. Such results
  522.        should be accurate enough for most purposes at least through
  523.        the end of 1995. (After that time, all bets are off unless an
  524.        updated version is prepared.) Those formulas are not, in
  525.        general, sufficiently accurate for eclipse predictions so you
  526.        may not want to spend a lot of time trying to do that. If
  527.        sufficient interest is shown (as measured by the number of
  528.        registered users .. say 100 or more), a more accurate version
  529.        will be prepared. As already stated above, MOONPO results are
  530.        not corrected for refraction. That would be overkill in view of
  531.        the low precison formulas used for position calculations.
  532.  
  533.  
  534.  
  535.  
  536.  
  537.        8.0  VALIDATION OF MOONPO RESULTS
  538.  
  539.        MOONPO's results have been checked for several geographical sites,
  540.        years and time of year by comparing its results with an updated
  541.        (in terms of ephemeris data) version of program ILLUM by Ir. A.C.
  542.        van Bochove's and M. Erlich. In virtually all cases tested, MOONPO
  543.        results for lunar and solar positions agree with those of ILLUM to
  544.        within two degrees or better. You can make a few judgements of your
  545.        own by printing the file ILUM93.DTA and running MOONPO for the
  546.        same conditions. ILUM93.DTA is a very, very small sampling of
  547.        calculations which were done using the updated ILLUM in testing
  548.        MOONPO.
  549.  
  550.        9.0 NOTICES
  551.  
  552.        Microsoft MS-DOS and Windows 3.x  are products of Microsoft
  553.        Corporation.
  554.  
  555.        Turbo Pascal for Windows is a product of Borland International.
  556.  
  557.        GSW.EXE and GSWDLL.DLL are products of Bits per Second, Ltd. and
  558.        Pinnacle Publishing, Inc.
  559.  
  560.        OS/2 is a product of International Business Machines (IBM).
  561.  
  562.        Revised 16 May 1994
  563.